home *** CD-ROM | disk | FTP | other *** search
/ Apple WWDC 1996 / WWDC96_1996 (CD).toast / Technology Materials / Multiprocessing SDK / Multiprocessing / MP API Library Read Me next >
Encoding:
Text File  |  1996-05-03  |  2.5 KB  |  50 lines  |  [ttro/ttxt]
  1.  
  2.                                      Multiprocessing API Library Read Me
  3.  
  4.                                                                                                Version 1.4
  5.                                                            May 1, 1996
  6.  
  7. This folder contains the release of the Multiprocessing API Library.
  8.  
  9. Contents
  10. As shipped, this folder should contain the following files and subfolders:
  11.  
  12.   MP.h                                               the MP API header file
  13.   Multiprocessing API Library             the shared library which implements the MP API
  14.         MP API Library Read Me                                                                    this file
  15.  
  16. For development prurposes you should drag the entire Multiprocessing folder from the SDK into your ':MacOS Support:Headers:System Extras Headers:' folder. If you are not using Metrowerks use whatever the equivalent folder in your development environment is. Make an alias to the Multiprocessing API Library and put it into your Extensions folder. 'The MP API FAQs' document explains this technique in more detail.
  17.  
  18. “Undocumented” Functions
  19. This section describes the “undocumented” features of the Multiprocessing API Library.  These routines are not part of the Apple/DayStar MP API specification and they are not guaranteed to be supported in Copland.  The primary reason for their inclusion into the Multiprocessing API Library is to facilitate the development and debugging of MP capable code.
  20.  
  21. _MPTaskIsToolboxSafe()
  22.  
  23. This Boolean function allows routines which are otherwise unaware that they are being called from an MP task to check to see if it is permissible to make a call to the Macintosh toolbox.  (It is okay to make toolbox calls only if the routine is not being called from an MP task).
  24.  
  25. _MPAllocateSys()
  26.  
  27. Does the same thing as MPAllocate() except the memory is allocated from the system heap.
  28.  
  29. _MPLibraryVersion()
  30.  
  31. Retrieves the hardcoded version information built into the currently active Multiprocessing API Library.
  32.  
  33. _MPDebugStr()
  34.  
  35. This function works just like DebugStr() except that it is safe to call it from an MP task.
  36.  
  37. _MPStatusPString()
  38. _MPStatusCString()
  39.  
  40. These functions provide a way to translate an OSStatus value returned from one of the MP API calls into either a Pascal string or a C string.  Thus, if an MPLibrary function returns an error then the application (not a task) could use the following:
  41.  
  42.     status = MPFunction( function_params );
  43.     DebugStr( _MPStatusPString( status ) );
  44.  
  45.  
  46. Support
  47. For support, send email to "mp@daystar.com" or call (770) 967 2077 x267.  We will have a mailing list for future releases of this API.
  48.  
  49. Copyright © Apple Computer, Inc. and DayStar Digital, Inc. 1995 - 1996
  50.